12.1. Финальная проверка вместо новой функции
Одиннадцать уроков позади. Игра умеет считать клики, показывать случайное сообщение, менять уровень магии, рассыпать искры и сбрасываться по кнопке. Новых возможностей в этом уроке не появится. Появится то, без чего не обходится ни один настоящий проект: умение находить ошибки и приводить код в порядок.
Ошибка — это не признак того, что «я плохой программист». Это обычная часть работы: код почти никогда не работает с первого раза. Разница между новичком и опытным автором не в том, что второй не ошибается, а в том, что он быстрее понимает, где именно ошибка. Браузер уже знает ответ — он пишет его в консоль.
Сегодня мы научимся трём вещам: читать сообщение об ошибке, находить её место в файле и проверять игру по чек-листу. А в конце разложим проект на три файла — так, как это делают настоящие сайты.
Меняй по одной вещи. Если править пять мест сразу, после ошибки будет непонятно, какая из пяти правок её вызвала. Изменил строку — сохранил, обновил, проверил. Работает — идёшь дальше.
12.2. Консоль: где браузер говорит с тобой
Консоль открывается клавишей F12 или сочетанием Ctrl+Shift+I. На вкладке Console появляются три вида сообщений: обычные (их печатает console.log), предупреждения (жёлтые) и ошибки (красные). Ошибка — самая полезная строка на экране, потому что в ней указано, что случилось и где.
Uncaught TypeError: Cannot read properties of null (reading 'textContent')
at magicClick (script.js:42:13)
Читать такую запись нужно по частям. TypeError — тип ошибки: код обратился к значению неподходящего типа. Cannot read properties of null — попытка прочитать свойство у null, то есть у «ничего». reading 'textContent' — какое именно свойство читали. Вторая строка указывает файл script.js, строку 42 и столбец 13, а в скобках — функцию magicClick, во время которой это произошло.
Слово Uncaught означает «не поймана»: ошибка не была обработана и остановила выполнение скрипта. Строка at magicClick (script.js:42:13) — ссылка: нажми на неё, и браузер откроет вкладку Sources на нужной строке. Это самый быстрый путь от сообщения к месту в коде.
Кроме ошибок, в консоль можно печатать свои сообщения: console.log выводит текст, console.warn — жёлтое предупреждение, console.error — красную ошибку. Для отладки удобнее всего первый: он не мешает странице и не останавливает игру.
12.3. Ошибка null: элемент не найден
Самая частая ошибка в нашем проекте выглядит так. В разметке сообщение имеет id="magicMessage", а в скрипте набрано #magicMesage — с пропущенной буквой «s». querySelector ищет элемент, не находит и возвращает null. Следующая строка пытается записать текст в это «ничего» — и скрипт останавливается.
const message = document.querySelector("#magicMesage");
message.textContent = "✨ Магия сработала!";
В консоли появится уже знакомая запись Cannot read properties of null или Cannot set properties of null — разница только в том, читали свойство или записывали. Причина одна: элемент с таким именем не найден. Обрати внимание: сама строка с querySelector ошибки не вызывает. Ошибка случается на следующей строке, когда код трогает null.
Как найти виновника за минуту: напиши console.log(message) сразу после поиска — в консоли будет null; открой Elements, найди нужный элемент и скопируй его id оттуда; сравни имена посимвольно, потому что magicButton и magicButon глаз почти не различает.
null, не ищи причину в CSS и не переписывай обработчик. Сначала проверь имя: в разметке — id, в скрипте — селектор. Совпадение должно быть точным, включая регистр букв.
12.4. Скрипт, который выполнился слишком рано
Браузер читает файл сверху вниз. Встретил разметку — построил элемент. Встретил скрипт — сразу выполнил его. Поэтому место скрипта в документе важно не меньше самого кода. Если поставить его в head, он выполнится раньше, чем появится body с кнопкой, и любой поиск вернёт null.
<head>
<script src="script.js"></script>
</head>
<body>
<button id="magicButton">✨ МАГИЯ! ✨</button>
</body>
В такой странице скрипт начнёт работать, когда кнопки ещё нет. Ошибка будет та же самая — Cannot read properties of null, хотя сам код написан правильно. Лечится это переносом строки в конец body, после всей разметки:
<body>
<button id="magicButton">✨ МАГИЯ! ✨</button>
<script src="script.js"></script>
</body>
В нашем проекте скрипт стоит в конце body с урока 7. Не переноси его в head «для порядка»: именно этот порядок делает код рабочим.
body и не работает в head. Прежде чем искать ошибку в коде, посмотри, где стоит тег script и что находится выше него.
12.5. Забытые скобки: вызов вместо ссылки
Скобки после имени функции означают «выполни её сейчас». Без скобок имя означает «вот эта функция, выполни её позже». В обработчике события нужен второй вариант: мы передаём функцию браузеру, чтобы он вызвал её при клике.
// правильно: передаём функцию, браузер вызовет её при клике
button.addEventListener("click", magicClick);
// неправильно: функция выполнится сразу, а обработчик получит undefined
button.addEventListener("click", magicClick());
Во втором случае при загрузке страницы magicClick сработает один раз, а на клики кнопка не отреагирует. Ошибки в консоли может не быть вовсе — именно поэтому такую поломку трудно заметить. Если кнопка «молчит», проверь скобки в addEventListener.
Другая ошибка со скобками — незакрытая фигурная скобка. Браузер не может понять, где заканчивается функция, и сообщает:
Uncaught SyntaxError: Unexpected end of input
Такая запись означает, что файл закончился раньше, чем браузер дочитал конструкцию. Синтаксическая ошибка отключает весь файл целиком: не выполнится ни одна строка, даже правильная.
12.6. Кириллица: буква, которой не видно
В русской раскладке есть буквы, которые выглядят почти как латинские: с и c, о и o, е и e, а и a, р и p, х и x. В шрифте редактора разница бывает незаметна, а для браузера это совершенно разные символы.
Правило простое: всё, что является частью кода — имена тегов, классов, id, переменных и функций, — пишется латиницей. Русские буквы допустимы только в тексте между тегами и в строковых значениях, которые видит игрок. Если сомневаешься, скопируй id из разметки в скрипт: копирование не переключает раскладку.
12.7. Файл не сохранён и старый кэш
Бывает, что ошибка уже исправлена, а страница показывает старое поведение. Проверь три вещи по порядку: файл сохранён (в заголовке вкладки редактора нет точки вместо крестика), открыт тот файл и та папка, страница обновлена после сохранения.
Иногда и это не помогает: браузер хранит копии файлов в кэше. Для страницы с диска кэш обновляется обычно сам, но CSS и JavaScript могут остаться старыми. Жёсткое обновление — Ctrl+F5 — загружает файлы заново, без копии из кэша.
F12 → Network и обнови страницу. Ты увидишь список файлов, которые загрузил браузер: index.html, style.css, script.js. Если нужного файла нет или у него красный статус, проблема в имени или пути, а не в коде. Галочка Disable cache на этой вкладке отключает кэш, пока инструменты открыты.
12.8. Elements: посмотреть, что на самом деле на странице
Вкладка Elements показывает не файл, а построенное дерево страницы: какие элементы существуют на самом деле, как вложены и какие у них атрибуты. Это лучший способ проверить id — прочитать имя в дереве, а не по памяти. Кнопка со стрелкой (или Ctrl+Shift+C) включает выбор элемента: щёлкни по кнопке на странице, и в дереве подсветится её строка.
Правки в Elements живут до обновления страницы, а файл на диске не меняется. Панель — микроскоп, а не редактор: рассматривать можно, лечить нужно в файле.
12.9. Sources и точки останова
Вкладка Sources показывает файлы проекта и позволяет остановить выполнение кода в выбранной строке. Нажми на номер строки слева — появится синяя метка, точка останова. Обнови страницу и нажми на кнопку: браузер остановится перед этой строкой, а справа будут видны значения переменных. Дальше F10 выполняет следующую строку, F8 продолжает до конца. Вместо метки можно временно вставить в код строку debugger;, но не забывай её удалять.
12.10. Три файла вместо одного
До сих пор весь проект лежал в одном index.html: разметка, стили в <style> и скрипт в <script>. Пока файл короткий, это удобно. Но в финальной игре больше двухсот строк, и найти в них нужное правило становится трудно. Настоящие сайты разделяют ответственность между файлами.
C:\magic-button\
index.html
style.css
script.js
index.html хранит только разметку. style.css — только оформление. script.js — только поведение. Каждый файл открывается отдельно, и ошибка в консоли сразу говорит, в каком из них её искать: style.css:87 или script.js:42.
Файлы нужно подключить. Таблица стилей — в head, чтобы оформление было готово до появления элементов. Скрипт — в конце body, после разметки:
<head>
<title>Волшебная кнопка</title>
<link rel="stylesheet" href="style.css">
</head>
<body>
...разметка игры...
<script src="script.js"></script>
</body>
У стилей адрес задаёт href, у скрипта — src. Путь "style.css" означает «файл лежит рядом с этой страницей»; если положить его в подпапку, путь изменится. Внутри отдельных файлов не нужны теги <style> и <script>: там пишется только содержимое.
12.11. Живой пример: код пишет в консоль
Посмотрим на связь «код → консоль» в действии. Открой F12, перейди на вкладку Console и нажми на кнопку в примере. Каждый клик будет добавлять в консоль строку: номер клика и случайное сообщение. На самой карточке тоже видно число кликов — так удобно, когда консоль закрыта.
console.log. В реальном проекте такие строки можно оставить на время отладки, а перед сдачей — убрать или закомментировать.Обрати внимание: console.log не меняет страницу. Он нужен, чтобы заглянуть внутрь программы, как в окно. Если сообщение в консоли есть, значит код до этой строки дошёл. Если сообщения нет, значит выполнение остановилось раньше — и консоль подскажет где.
12.12. Чек-лист финальной игры
Готовую игру проверяют по списку, а не «на глаз». Пройди пункты по порядку и отметь каждый. Если пункт не выполняется, вернись к нужному уроку.
- Файл открывается в браузере, вкладка называется «Волшебная кнопка», в папке лежат три файла.
- Стили подключены в
head, скрипт — в концеbody. - Консоль при загрузке пустая: ошибок нет.
- Кнопка «✨ МАГИЯ! ✨» реагирует на наведение и нажатие.
- После клика число заклинаний увеличивается на единицу.
- Сообщение под кнопкой меняется и берётся из массива.
- Уровень совпадает с числом кликов на границах 5, 10, 20, 30 и 50.
- Искры появляются и исчезают примерно через секунду.
- Кнопка сброса спрашивает подтверждение и обнуляет игру.
- На числах 10, 25 и 50 появляется поздравление.
12.13. Итог урока
Ты научился читать ошибки и собирать проект из трёх файлов. Это последний шаг курса, но не последний шаг игры: теперь её можно развивать самостоятельно, и ты знаешь, где искать помощь, если что-то сломается.
- Консоль показывает тип ошибки, файл, строку и функцию — начинай разбор с этих данных.
nullв ошибке почти всегда означает, что элемент не найден: проверьidи место скрипта.- Скрипт должен стоять после разметки, иначе элементы ещё не существуют.
magicClickв обработчике — без скобок; со скобками функция выполнится сразу.- Кириллическая буква в имени выглядит как латинская, но браузер считает её другой.
- Три файла —
index.html,style.css,script.js— разделяют разметку, оформление и поведение.
Что дальше
Игра готова, но её не обязательно оставлять такой. Самое интересное начинается, когда ты добавляешь то, чего в курсе не было. Вот несколько идей, которые работают с теми же тремя файлами.
- Сохранение прогресса.
localStorageзапоминает число кликов между открытиями страницы. - Свои сообщения. Замени строки в
magicMessages— игра сразу станет другой. - Новые уровни. Добавь звание на 100 кликах и проверь лестницу условий.
- Таймер. Пусть игра считает, сколько кликов сделано за 30 секунд.
Каждая доработка — это снова цикл «правка → сохранение → проверка в консоли». Если что-то сломается, начни с консоли: она подскажет файл и строку быстрее любого учебника.